home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / gif_vu61.zip / MVGAVU.DOC < prev    next >
Text File  |  1991-12-09  |  36KB  |  778 lines
  1.             MVGAVU (c) Copr. 1989-91 Lawrence Gozum & Marvin Gozum
  2.             ──────────────────────────────────────────────────────
  3.  
  4.                                  User Manual
  5.  
  6.  
  7.     DISCLAIMER
  8.  
  9.     This product is distributed AS IS.  The authors specifically disclaim all
  10.     warranties ,expressed or implied, including ,but not limited to, implied
  11.     warranties of merchantability and fitness for a particular purpose with
  12.     respect to defects in the diskette and documentation, and program license
  13.     granted herein, in particular, and without limiting operation of the
  14.     program license with respect to any particular application use or
  15.     purpose.  In no event shall the authors be liable for any loss of profit
  16.     or any other commercial damage including but not limited to special,
  17.     incidental, consequential or other damages.
  18.  
  19.  
  20.     LICENSING AGREEMENT
  21.  
  22.     You may use this program for a 10 DAY TRIAL PERIOD.  Should you find this
  23.     program useful, you MUST register it; you will then be provided with the
  24.     latest releases of the VGACAD system see last section of this manual).
  25.  
  26.     Freely distribute unmodified MVGAVU copies provided you charge $10 max.
  27.     for distribution, in lieu of recognized Users Group guidelines (eg., ASP).
  28.  
  29.  
  30.     WHAT IS MVGAVU ?
  31.  
  32.     MVGAVU is a GIF decoder/viewer/slideshow utility and component of VGACAD.
  33.     MVGAVU handles GIFs up to 2KBx2KBx256 and shows the whole picture w/out
  34.     scrolling; it also features a UNIQUE 256-color rendering scheme in
  35.     16-color EGA/VGA/SVGA modes for viewing multiple/animated images.  As a
  36.     versatile slideshow, it automatically determines the BEST viewing mode.
  37.  
  38.     You can also view PCX (Zsoft/PCPaintbrush) support for 2-color, 16-color
  39.     and 256-color image files.
  40.  
  41.     MVGAVU supports TARGA file (16/24/32 bits) viewing through unique
  42.     16/256-color rendering schemes to view all those THOUSANDS of "colors"
  43.     in ALL modes supported.  BMP (Windows 3.x) 16-color, 256-color and
  44.     24-bit (16.7 Million color) image files are also supported.
  45.  
  46.     New! HiColor emulation added to see those 16/24/32-bit Targa and 24-bit
  47.     BMP files as if you had a 16384-color mode.
  48.  
  49.     Real HiColor support lets you see those 16/24/32-bit Targa and 24-bit
  50.     BMP files in 640x480x32K (eg., ATI VGA Wonder XL) and/or 800x600x32K
  51.     with Tseng 4000 cards w/ Sierra DAC
  52.  
  53.              eg. Cardinal VGA732
  54.              Diamond SpeedSTAR HiColor
  55.              Focus 2 the Max VGA4000
  56.              Micro-Labs Ultimate VGA/HiColor
  57.              Orchid Prodesigner IIs
  58.              SOTA Lightning VGA
  59.              STB PowerGraph Ergo-VGA HiColor
  60.              United Ultra Image HiColor
  61.  
  62.  
  63.     REQUIREMENTS
  64.  
  65.     MVGAVU requires a PS/2 or EGA/MCGA/VGA/SVGA video card.  512KB of
  66.     RAM is required, although it uses less than that.  The BRUN41.exe
  67.     runtime module MUST be present in your DOS path.
  68.  
  69.  
  70.     CONFIGURING MVGAVU
  71.  
  72.     BEFORE DOING ANYTHING, configure MVGAVU by selecting (C)ard; MVGAVU
  73.     is initially set for "VGA or PS/2 Model 50".  If the "VESA" setup was
  74.     configured previously, you MUST configure MVGAVU by typing
  75.  
  76.                         "MVGAVU -C" <ret>.
  77.  
  78.     A list of Video card "types", based on their chipset family, are
  79.     presented.  Enter the number that matches your card.  When selecting
  80.     SVGA cards, check your manual or manufacturer for the chipset (e.g.,
  81.     ATI, Tseng, Paradise, Video7, Oak, etc..); when in doubt, select
  82.     choices 253, 254 or 255.  You will also be asked to specify the amount
  83.     of video RAM present and, if ATI or Tseng4000 chipsets are selected,
  84.     HiColor capability option.  HercGS users will be asked if a 1024x768
  85.     non-interlaced monitor is present to modify the 1024x768x256 mode.
  86.  
  87.         BE SURE THAT MVGAVU.EXE IS LOCATED IN YOUR
  88.         DEFAULT DRIVE/PATH TO ENSURE HARCODING.
  89.  
  90.     Trident TVGA card users that have the supposedly rare 'BR versions'
  91.     will notice that the bank switching will be erroneous.  We tried to
  92.     accomodate this version but ended up compromising the more popular
  93.     TVGA 8800 and 8900 versions <sorry>.
  94.  
  95.     The Trident 1024x768x256 mode is not supported at this time since it
  96.     uses a very peculiar, card specific, bank switching methodology (ie.,
  97.     it conflicts with SVGA display conventions).  Video mode support is
  98.     limited to 800x600x256 or 1024x768x16, if available.
  99.  
  100.     Some Everex 678 (w/ Trident chip) have experienced compatibility
  101.     problems.  If the 1024x768x16 mode works but fails in all other modes,
  102.     then you may have a defective card.  Try using the VESA setting
  103.     described below; if that fails then you really have a problem card.
  104.  
  105.  
  106.     LAUNCHING MVGAVU AS A DOS APPLICATION UNDER WINDOWS 3.X
  107.  
  108.     HERCULES STATION CARD USERS SHOULD NOT USE THIS OPTION.
  109.     ======================================================
  110.  
  111.     Before implementing the following steps, please ensure that the
  112.     BRUN41.EXE file has access to your PATH or has been copied into the
  113.     \WINDOWS\SYSTEM sub-directory.
  114.  
  115.     1.  If you don't have a PROGRAM GROUP for DOS applications then
  116.  
  117.     1.1.    Click "File" under the Program Manager window.
  118.     1.2.    Select "New".
  119.     1.3.    Select "Program Group".
  120.     1.4.    Click "OK".
  121.     1.5.    Enter a DESCRIPTION for this "Program Group"
  122.         (eg., "DOS Apps")
  123.     1.6.    Click "OK".
  124.  
  125.     2.  Click (activate) your "DOS Apps" window.
  126.     3.  Click "File" under the Program Manager window.
  127.     4.  Select "New".
  128.     5.  Select "Program Item".
  129.     6.  Click "OK".
  130.     7.  Enter the full pathname of MVGAVU at COMMAND LINE and include
  131.     any Command Line processing option (if desired) discussed at a
  132.     latter section of this manual.
  133.  
  134.     eg., If MVGAVU.EXE is located under the \VGACAD directory then
  135.          enter "\VGACAD\MVGAVU" at the COMMAND LINE.
  136.  
  137.          If you wanted the AutoMode processing option to be activated
  138.          to select video modes up to 1024x768x256 then you would enter
  139.          "\VGACAD\MVGAVU -m" at the COMMAND LINE.
  140.  
  141.     NOTE: You can also use the BROWSE function of this window to
  142.           select MVGAVU instead of actually typing it in at the
  143.           COMMAND LINE.
  144.  
  145.     8.  If you wish, "Change Icon" - "DOS" icon is preferred though.
  146.     9.  Click OK.
  147.  
  148.  
  149.     VESA IMPLEMENTATION
  150.  
  151.     MVGAVU now supports the VESA (Video Electronics Standards Association)
  152.     application interface.  By selecting VESA (ie., card "18"), virtually
  153.     all SVGA modes supported by your card can be utilized and integrated
  154.     with all of MVGAVU's processing options.  VESA mode support includes:
  155.  
  156.             800x600x16
  157.             640x400x256
  158.             640x480x256
  159.             800x600x256
  160.             1KBx768x16
  161.             1KBx768x256
  162.  
  163.     VESA support requires you to load a card-specific resident program
  164.     before VESA can be used.  An error message - "VESA not detected!"
  165.     will result if VESA has not been previously loaded.
  166.  
  167.     Under certain circumstances, MVGAVU will reject a VESA mode; it will not
  168.     become available if it conflicts with "common" SVGA implementation.  Any
  169.     mode that requires two windows ("bank switching methods") to read and
  170.     write to video memory or uses a window other than A000 hex will be
  171.     rejected (eg., Trident 8900 1024x768x256 mode).
  172.  
  173.     The old ATI SVGA 1024x768x16 mode (trigerred via mode 65 hex) is not
  174.     supported via VESA - it is supported and hardcoded if you select the
  175.     ATI card instead of VESA.  With the new ATI cards you can have ALL
  176.     VESA modes or hardcoded modes up to 1024x768x256.
  177.  
  178.  
  179.     LOADING PICTURES INTO MVGAVU
  180.  
  181.     MVGAVU accepts [G]IF, [T]arga, [W]indows (BMP), PCX (PC Paintbrush) or
  182.     [B]ASIC (BLD+PLT) file types.  Select any filename by moving a high-
  183.     lighted bar (with arrow keys) and pressing <return> key.  If you have
  184.     more than 184 files, the columns of files listed will scroll when either
  185.     margin of the screen is reached.  <Home> moves to the first file while
  186.     <End> moves to the last file.  <PgDn> shows the next 184 files while
  187.     <PgUp> shows the previous.  <Spc> allows changes to the PATH, while
  188.     <Esc> exits.  BLD files MUST have a corresponding *.PLT file or a error
  189.     message will follow.
  190.  
  191.  
  192.     COMPATIBILITY
  193.  
  194.     The BRUN41.exe runtime module HATES 'Shadow RAM' (eg., putting your
  195.     VIDEO BIOS in low or high RAM); it 'hangs' (at least on our 386 SX).
  196.     If MVGAVU 'locks-up' at start-up then you have this problem too;
  197.     disable 'Shadow RAM' (eg., via CMOS set-up) and it should work.
  198.  
  199.     There are several COMMAND LINE OPTIONS that are NOT available from the
  200.     MVGAVU Expert Menu.  All other processing options described in a latter
  201.     section of this manual can be invoked despite these option settings.
  202.  
  203.             MVGAVU -H <ret>
  204.  
  205.     "-H" HiColor Enable. If HiColor modes are not setup during configuration
  206.     then it can be accessed this way.  If this command is invoked from the
  207.     command line, HiColor (32KB-color) modes will be made available at the
  208.     Expert Menu when Targa 16/24/32 or BMP 24-bit files are detected.  No
  209.     verification of HiColor capability is done, CHECK YOUR CARD'S MANUAL
  210.     TO SEE IF IT SUPPORTS IT!
  211.  
  212.     Note: HiColor modes and the CEG/Edsun DAC modes are totally different;
  213.       the former is a "true" 32KB color mode while the latter is a
  214.       peculiar "anti-aliasing"/smoothing mode which is NOT supported
  215.       by MVGAVU at this time.
  216.  
  217.  
  218.                         MVGAVU -D <ret>
  219.  
  220.     "-D" Disable Auto-Expanded Memory usage.  Expanded memory is required
  221.     for those GIF89a "crashers" that require MASSIVE amounts of memory to
  222.     restore a screen.  The LIM 4.0 EMS spec is required to use expanded
  223.     memory, if your EMS driver does not conform then unpredictable results
  224.     will happen such as getting strange colors in restored areas.  Disable
  225.     Auto-EMS usage to allocate 96KB of low RAM for screen storage; this
  226.     should work with most GIF 89a images that conform to Jim Burton's
  227.     "Rules for GIF89a MIGs". 
  228.    
  229.  
  230.                         MVGAVU -E <ret>
  231.  
  232.     "-E" EGA only mode forces EGA 640x350x16 to be the ONLY mode to be
  233.     selected by the user or MVGAVU during automatic mode selection (ie.,
  234.     hitting <return> key.
  235.  
  236.     If you are having compatibility problems (particularly SVGA mode and/or
  237.     bank switching) with MVGAVU please contact Lawrence Gozum [73437,2372]
  238.     via CompuServe's
  239.  
  240.                   E-Mail
  241.                 or
  242.                 PICs Forum
  243.  
  244.  
  245.     VIEWING TARGA FILES IN MVGAVU v6.0
  246.  
  247.     o Only UNCOMPRESSED, UNMAPPED Targa (16/24/32 bit) files are
  248.       supported; an error code will result telling you that that specific
  249.       file is not yet supported.
  250.  
  251.     o TARGA files must be <= 2048x2048.
  252.  
  253.     o In 256-color modes, a HiColor emulation mode with 16384 colors is
  254.       trigerred.  This new algorithm provides maximum color depth with
  255.       smooth continuous tones; there are barely any noticeable diffrences
  256.       with REAL HiColor modes and the HiColor emulation modes when these
  257.       SVGA modes are selected - 640x480x256, 800x600x256 and 1024x768x256.
  258.  
  259.     o In 16-color mode, 2x2 "SuperPixels" are used.  Although this limits
  260.       resolution, it effectively provides sufficient color depth to view
  261.       16/24/32-bit TGA images.
  262.  
  263.     o AutoCentering is disabled.
  264.  
  265.     o HiColor 640x480x32KB or 800x600x32KB modes (eg., Diamond Speedstar,
  266.       and ATI VGA Wonder XL) are made available when Targa files are
  267.       detected.
  268.  
  269.     o If HiColor capability is initially configured, then the AutoMode
  270.       function will select from available HiColor modes, otherwise
  271.       an appropriate HiColor emulation mode will be selected.
  272.  
  273.     o HercGS 512x480x16M mode is made available when Targa 24/32 files
  274.       are detected; saving the screen in this mode is disabled.
  275.  
  276.     o Saving the screen in REAL HiColor modes or HercGS's 640x480x16K
  277.       and 512x480x16M modes are disabled.  Saving images viewed with
  278.       HiColor emulation modes are enabled.
  279.  
  280.  
  281.     Note: TGA files are best viewed with the "Fix Aspect 1:1" or
  282.       "Fix Aspect TGA" processing option.  In 256-color modes, view
  283.       TGA files with the highest mode possible (eg., 1KBx768x256).
  284.       In 16-color modes, use the grey processing option for maximum
  285.       detail; processing options are discussed in latter section.
  286.  
  287.  
  288.     VIEWING BMP (Windows 3.x) FILES WITH MVGAVU v6.0
  289.  
  290.     o Only UNCOMPRESSED 16-color, 256-color and 24-bit (16.7 MB color)
  291.       files are supported.
  292.  
  293.     o BMP files must be <= 2048x2048.
  294.  
  295.     o In 256-color modes, a HiColor emulation mode with 16384 colors is
  296.       trigerred.  This new algorithm provides maximum color depth with
  297.       smooth continuous tones; there are barely any noticeable diffrences
  298.       with REAL HiColor modes and the HiColor emulation modes when these
  299.       SVGA modes are selected - 640x480x256, 800x600x256 and 1024x768x256.
  300.  
  301.     o In 16-color mode, 2x2 "SuperPixels" are used.  Although this limits
  302.       resolution, it effectively provides sufficient color depth to view
  303.       24-bit BMP images.
  304.  
  305.     o Slideshows are disabled.
  306.  
  307.     o AutoCentering is disabled.
  308.  
  309.     o As with HercGS modes with 32KB or 16MB colors, HiColor 640x480x32KB
  310.       or 800x600x32KB modes (eg., Diamond SpeedSTAR, and ATI VGA Wonder XL)
  311.       are made available when 24-bit BMP files are detected.
  312.  
  313.     o Saving the screen in REAL HiColor modes or HercGS's 640x480x16K
  314.       and 512x480x16M modes are disabled.  Saving images viewed with
  315.       HiColor emulation modes are enabled.
  316.  
  317.     Note: BMP files are best viewed with "Fix Aspect 1:1" processing
  318.       option discussed in latter section. In 256-color modes, view
  319.       TGA files with the highest mode possible (eg., 1KBx768x256).
  320.       In 16-color modes, use the grey processing option for maximum
  321.       detail; processing options are discussed in latter section.
  322.  
  323.  
  324.  
  325.     VIEWING PCX FILES WITH MVGAVU v6.0
  326.  
  327.     o Only RLE 2-color, 16-color and 256-color image files are supported
  328.       (essentially covers ALL PCX files except CGA 4-color image files).
  329.  
  330.     o PCX files must be <= 2048x2048.
  331.  
  332.     o Slideshows are disabled.
  333.  
  334.     o AutoCentering is disabled.
  335.  
  336.  
  337.     SELECTING VIDEO MODES
  338.  
  339.     On default MVGAVU is set to AutoMode with "Expert Menu:OFF"; after
  340.     selecting a file, MVGAVU will immediately show the image.  Pressing
  341.     <return> after picking a GIF file triggers automatic mode selection.
  342.     MVGAVU selects the BEST video mode, based on your video card
  343.     configuration.  Pressing <Esc> aborts viewing and lets you reselect
  344.     a new file.
  345.  
  346.     Set "Expert Menu:ON" at the opening menu if you want to use processing
  347.     options or to select specific video modes for viewing.
  348.  
  349.  
  350.     HiColor modes
  351.  
  352.     640x480x32KB or 800x600x32KB modes (eg., Diamond Speedstar, and ATI VGA
  353.     Wonder XL) are supported by MVGAVU.  HiColor modes are made available
  354.     at the Expert Menu ONLY when Targa 16/24/32-bit or BMP 24-bit files are
  355.     detected.  Automode support is provided if you have configured MVGAVU
  356.     with the HercGS card or HiColor capability (ie., via card selection)
  357.     PLEASE CHECK YOUR CARD'S MANUAL TO VERIFY AVAILABILITY !
  358.  
  359.      *  If HiColor capabilty is not configured at the start then
  360.         invoke the "-H" command line option (ie., "MVGAVU -H");
  361.  
  362.     To view images in HiColor modes,
  363.  
  364.     (1) turn Expert Menu ON;
  365.     (2) pick a Targa 16/24/32-bit or BMP 24-bit file;
  366.     (3) select mode (eg., [H]iColor 640x480x32K) at the Expert Menu.
  367.  
  368.     or simply use the COMMAND LINE format discussed at a latter section
  369.     of this manual.
  370.  
  371.     Unsupported MVGA (Medium-resolution VGA) modes
  372.  
  373.     The 320x400x256 mode is the safest since it uses minimal VGA register
  374.     modification and is safely within tolerances of PS/2 monitors; it should
  375.     run on any "register-compatible" VGA card.  It has an interesting aspect
  376.     ratio - double the vertical resolution of MCGA/VGA 320x200x256; many
  377.     Amiga, Atari and MacII GIFs have this aspect ratio; viewing GIFs in this
  378.     mode replicates "what the originator saw".  If the 320x400x256 mode
  379.     fails, your card is BIOS-COMPATIBLE ONLY !
  380.  
  381.     The 360x480x256 mode pushes generic VGA cards to its theoretical limits!
  382.     With 270% more resolution, view 640x480x256 GIFs with more detail and
  383.     less "jaggies".  If the 360x480x256 mode fails, your card is not as
  384.     "register-compatible" as it claims to be.
  385.  
  386.     The 640x400x256 Tseng SVGA was created to view 320x200x256 GIFs more
  387.     clearly due to 400% more resolution - aside from adding the missing
  388.     mode to its SVGA repertoire.  Amiga, Atari and MacII GIFs use this
  389.     aspect ratio multiple and look as close as possible to "what the
  390.     originator saw" with it.
  391.  
  392.     View Jovian VIA scans (320x240x256 GIFs) in 640x480x256 or 800x600x256;
  393.     these GIFs have the same aspect ratio and have the same effect as
  394.     viewing 320x200x256 GIFs in the 640x400x256 mode.
  395.  
  396.  
  397.     Preset SVGA modes
  398.  
  399.     MVGAVU has hardcoded support for many SVGA chipsets based on your video
  400.     card configuration.  SVGA MODES ARE NOT VERIFIED; YOUR VIDEO RAM AND
  401.     CHIPSET LIMITS YOUR CHOICES; CHECK YOUR MANUAL !!!
  402.  
  403.  
  404.     SVGA/EEGA User modes
  405.  
  406.     SVGA/EEGA User modes are made available ONLY when HiColor modes are
  407.     disabled.  Only one or the other are made available.
  408.  
  409.     To use User modes, press [U]ser Mode.  On default, this mode is set to
  410.     EGA 640x200x16.  To set your own modes specify the Screen Width, Screen
  411.     Height, colors (16 or 256), Video Mode, and Chip type (9=EEGA).  Several
  412.     *.CFG files are included; copy a special video mode (e.g., 512x480x256)
  413.     to MVGAVU.CFG and it will be invoked when you use the "U" option.  CHECK
  414.     YOUR CARD'S MANUAL TO DETERMINE IF IT SUPPORTS IT!
  415.  
  416.     To set a 256 or 16 color mode, press [R]evise.  Once edited, it is saved
  417.     and recalled anytime.  Type the video mode in decimal (e.g. 255) or hex
  418.     (e.g. &HFF); HEX ENTRIES *MUST* BE PRECEDED BY THE "&H" CHARACTERS.
  419.     16-COLOR MODES (UP TO 800x600 EXCEPT EVEREX & VIDEO7 MODES) MUST ALWAYS
  420.     USE "9" (for EEGA) SINCE IT WILL TELL MVGAVU TO USE THE HARDCODED
  421.     STANDARD PROCEDURE.  FOR MODES ABOVE 800x600 (e.g. 1024x768), YOU MUST
  422.     USE THE CORRECT CHIPSET (eg., ATI, PARADISE, TSENG, VIDEO7, ...).
  423.  
  424.  
  425.     EGA/EEGA/VGA 16-Color Modes
  426.  
  427.     If a GIF or BMP or PCX file has more than 16 colors (e.g, 256) then a
  428.     unique 16-color rendering method will implemented (eg., 640x350x16).
  429.  
  430.  
  431.     PROCESSING OPTIONS
  432.  
  433.     There are SEVEN (7) processing options:
  434.  
  435.                         Safety w/ MIGs
  436.                         Normal w/ MIGs
  437.                         OneMeg w/ MIGs
  438.                         Fit to Screen
  439.                         Fix Aspect 1:1
  440.             Fix Aspect TGA
  441.             Fix Aspect 5:6
  442.  
  443.     The first six options can be triggered from the command line.
  444.  
  445.     "Normal w/ MIGs" - this is the optimal processing option.  Multiple
  446.     Image Graphics/GIFs (87a and 89a) will be rendered.  Depending on your
  447.     card configuration, when using automatic mode selection (ie., <return>)
  448.     or command line viewing, the best video mode will be selected; this will
  449.     include 800x600x256 and 1024x768x16 modes, if available.
  450.  
  451.     Note: Old Paradise cards excluded 800x600x256 and 1024x768x16 modes;
  452.       USE ONLY THE "Safety w/ MIGs" OPTION BELOW IF YOU HAVE THE
  453.       OLD PARADISE CARDS.
  454.  
  455.     "Safety w/ MIGs" - this option is the DEFAULT; it is similar to "Normal
  456.     w/ MIGs" but excludes the 800x600 and 1024x768 modes, even if they are
  457.     available to ensure that fixed-frequency monitors, with 640x480 as its
  458.     max, will not be affected.  Moreover, setting this option will avoid
  459.     calling the 800x600 or 1024x768 modes which is excluded by some video
  460.     cards (eg., old Paradise cards and some Trident cards).
  461.  
  462.     "OneMeg w/ MIGs" - this is essentially similar to the "Normal w/ MIGs"
  463.     option but includes the 1024x768x256 mode, if available.
  464.  
  465.     Note: The processing options (above) will call the "Fit to Screen"
  466.       processing option (below) if the image exceeds screen parameters.
  467.       The AutoMode <return> key is disabled with the following options.
  468.  
  469.     "Fit to Screen" - this option decodes the FIRST image and fits that
  470.     image to maximum screen dimensions.  This is useful for resizing images
  471.     and subsequently saving/encoding them with the [tab] option described in
  472.     a latter section of this manual.
  473.  
  474.     "Fix Aspect 1:1" - with this option, certain GIFs that have the same
  475.     screen and image descriptors (e.g.CARMEN2) will be corrected for
  476.     accurate rendering (otherwise they will seem distorted).  "1:1" aspect
  477.     assumes originator was using a "square" aspect ratio.  If you have 100
  478.     pixels on all sides of a square, the square should appear as a SQUARE on
  479.     your monitor, not some rectangle.  320x240(Jovian VIA), 640x480, 800x600
  480.     and 1024x768 modes should have "square" aspect ratios.  Use this option
  481.     to fix such GIFs (e.g., SYLVIA.GIF, PAULINA.GIF, FMAID.GIF, ... ).
  482.     BMP FILES ARE BEST VIEWED WITH THIS PROCESSING OPTION SINCE THERE IS
  483.     NO IMAGE/SCREEN DIFFERENTIATION.
  484.  
  485.     "Fix Aspect 5:6" - this option is similar to the 1:1 processing option
  486.     but assumes that the originator was using a 320x200 or 640x400 screen
  487.     aspect ratio (eg., Amiga, Atari or MacII).  AutoMode <return> key is
  488.     disabled.
  489.  
  490.     Note: Almost all SVGA cards, due to monitor and "clock" contraints
  491.       tend to implement the 800x600x256 mode with a 5:6 rather than
  492.       a 1:1 aspect ratio.
  493.  
  494.     "Fix Aspect TGA" - this mode is intended for viewing TARGA (*.TGA) files
  495.     which typically originate from a 512x480 screen.  If the image looks
  496.     "too fat" then use the "Fix Aspect 1:1" processing option.
  497.  
  498.  
  499.     GREY CONVERSION
  500.  
  501.     If you require grey images for desktop publishing (DTP) applications,
  502.     then use MVGAVU's grey processing option at the Expert Menu.  By simply
  503.     pressing the [G]rey Option, all images will be converted to grey shades.
  504.  
  505.     Viewing TARGA images with the option is particularly useful if you
  506.     want to see a LOT of detail, albeit without color.  If you view TARGA
  507.     images with this option and subsequently save it, you can process the
  508.     file for DTP or printing with GIFPUB !  The palette contrast and
  509.     brightness functions will work with this option, making it an ideal
  510.     preprocessor for DTP.
  511.  
  512.  
  513.     ADJUSTING THE VIDEO MODE
  514.  
  515.     This feature is disabled when using extended Hercules Graphics Station
  516.     or HiColor (32KB color) video modes.
  517.  
  518.     WARNING: TO USE THIS FEATURE YOU *MUST* HAVE A REGISTER-COMPATIBLE VGA
  519.     CARD AND MULTIFREQUENCY MONITOR. DEPENDING ON SOPHISTICATION OF YOUR
  520.     HARDWARE, MINOR ADJUSTMENTS TO VIDEO MODES MAY TOTALLY DISRUPT THE VIDEO
  521.     SYNCING PROCESS, BE PREPARED TO PRESS THE "*" KEY TO RESET IF SYNC
  522.     SIGNALS ARE UNFAVORABLY DISRUPTED.
  523.  
  524.     Some video modes (e.g., 800x600) have distorted aspect ratios (i.e.,
  525.     supposed to have 1:1 aspect ratios but isn't).  To correct this, you can
  526.     (1) compress the image vertically/horizontally or (2) offset the image
  527.     on your monitor as if you were adjusting the vertical and horizontal
  528.     scanning controls of your monitor.  If you set your monitor for
  529.     1024x768x16, you will normally find that modes such as 960x720x16 tend
  530.     to be distorted.
  531.  
  532.     There is a growing amateur interest in VIDEO GRAPHICS via 'GENLOCK'
  533.     add-on cards (e.g., Jovian VIN, Willow VGA-TV).  By adjusting the video
  534.     mode you can control the aspect ratio and overall image size sent to your
  535.     TV or video tape.  320x200 and 640x400 modes tend to send images that are
  536.     smaller than the total TV/Video image; centering may be required.  With
  537.     640x480 or greater modes, the image may tend to be larger or distorted;
  538.     aspect ratio, image size and location adjustments may be required to
  539.     match 'real' video images with your computer graphic images.
  540.  
  541.     After an image is displayed, press "[A]djust Monitor.  The following key
  542.     options will be activated; this feature can be invoked in any video mode.
  543.  
  544.     [->]  move image right               [ - ] compress horizontal aspect
  545.     [<-]  move image left                [ + ] decompress horizontal aspect
  546.     [dn]  move image down                [Ins] compress vertical aspect
  547.     [up]  move image up                  [Del] decompress vertical aspect
  548.                                          [ * ] RESET ADJUSTMENTS
  549.                                          [Esc] exit
  550.  
  551.  
  552.     ADJUSTING CONTRAST & BRIGHTNESS
  553.  
  554.     This feature is disabled when using extended Hercules Graphics Station
  555.     or HiColor (32KB color) video modes.
  556.  
  557.     If you view in any mode except EGA, you can adjust contrast, brightness,
  558.     and color level.  Virtually ALL palette modifications can be emulated
  559.     with these "knobs".  Moreover, you can add or substract individual
  560.     quanta of red, green or blue components.
  561.  
  562.     Make sure your NUMLOCK key is OFF !
  563.  
  564.     [Esc] or any other key (e.g., [return] or [spc]) will exit.
  565.  
  566.     [->]  increase brightness            [+] increase color level
  567.     [<-]  decrease brightness            [-] decrease color level
  568.     [dn]  increase contrast              [*] reset palette
  569.     [up]  decrease contrast              [A] Adjust Monitor
  570.  
  571.     The following keys are CASE SENSITIVE.
  572.  
  573.     [R]   increase RED level             [r] decrease RED level
  574.     [G]   increase GRN level             [g] decrease GRN level
  575.     [B]   increase BLU level             [b] decrease BLU level
  576.  
  577.     With VGACAD you can import the adjusted palette in your edited picture
  578.     by pressing [backspace] key.  When editing a SVGA GIF via VSCRN (i.e.,
  579.     "virtual screen"); eNCODe that GIF and view it with MVGAVU; adjust the
  580.     palette, press [backspace] then exit to import that palette. 
  581.  
  582.  
  583.     SAVING RESIZED MVGA/SVGA GIFs OR MIGS (Multiple Image Graphics/GIFs)
  584.  
  585.     You can 'downsize' (squeeze) SVGA GIFs (e.g., 640x480x256) or expand
  586.     small GIFs (e.g., 320x200x256) to 320x400x256 or 360x480x256.  Downsize
  587.     SVGA GIFs for fast-decoding or enlarge small GIFs for enhanced image
  588.     processing with VGACAD or reduce odd SVGA GIFs (e.g., DGNLDY) to smaller
  589.     SVGA modes (e.g., 640x400x256).  View your GIF with any video mode and
  590.     press the [tab] key.
  591.  
  592.     MVGASCRN.RAW and MVGASCRN.PLT files will be created for GIF, PCX or BMP
  593.     (Windows 3.x) encoding with VGAFIL.  NYBLSCRN.RAW and NYBLSCRN.PLT files
  594.     will be created for 16-color GIF encoding with VGAFIL.  Subsequent saves
  595.     overwrite these files; encode with VGAFIL (which can be found in the
  596.     *.ZIP files of VGACAD (v2.0 and up) or VGACAP (v6.0 and up), and rename
  597.     immediately to preserve them.
  598.  
  599.     MIGs are usually several 'overlayed' images which simulate animation. 
  600.     MVGAVU supports GIF MIGs.  Since MIGs tend to change what you initially
  601.     see from what you see at the end of the GIF, you may want to save the
  602.     final rendered image rather than the first one for editing with VGACAD
  603.     or conversion to another image format or mode.  Simply save the final
  604.     rendered image as you would a resized image (ie., using the [tab] key)
  605.     and convert it with VGAFIL.  VGAFIL supports GIF, PCX, TGA (Targa 16)
  606.     and BMP (Windows 3.x) encoding to edit the image with any program that
  607.     supports those file formats.
  608.  
  609.  
  610.     GIF & TGA SLIDESHOWS
  611.  
  612.     Up to 4096 GIF of TGA files can be viewed in a slideshow.  Move the
  613.     cursor to select files and press [+] key to mark or [-] to unmark.
  614.     After selecting files press [S]how to start and you will be presented
  615.     with transition options.  You can adjust the "delay" factor between
  616.     each "slide" by adding pauses up to 30 seconds and use one of the
  617.     various transition effects.  During the show, press any key (three to
  618.     four times) while the show is running to exit.  MVGAVU selects optimal
  619.     video modes based on your video card configuration and command line
  620.     processing option selected.
  621.  
  622.  
  623.     COMMAND LINE VIEWING & BATCH PRESENTATIONS
  624.  
  625.     MVGAVU can be used in batch (*.BAT) files for presentations.  In Command
  626.     Line mode, only your picture is displayed and pressing any key (except
  627.     [tab], [backspace], [A]djust Monitor and Color/Picture adjustment keys)
  628.     after its display will end the program.  No menus or prompts interfere.
  629.  
  630.     Type "MVGAVU ?" for help or type
  631.  
  632.            "MVGAVU [processing option] filename <ret>"
  633.  
  634.             -S  Safety w/ MIGs (default)
  635.             -N  Normal w/ MIGs
  636.             -M  OneMeg w/ MIGs
  637.             -E  EGA    w/ MIGs
  638.             -F  Fit to Screen
  639.             -H  HiColor Enable
  640.             -A  Fix Aspect 1:1
  641.             -T  Fix Aspect TGA
  642.  
  643.     with no extension and optional path (e.g.,MVGAVU \gif\wett).  GIF, PCX,
  644.     BMP and TGA files are viewed via automatic mode selection; the range of
  645.     video modes selected from and how the graphic is rendered depends on
  646.     your video card configuration and processing option selected.
  647.  
  648.     MVGAVU searches for the first matching *.GIF, then it searches for a
  649.     *.TGA file then, then a *.BMP file, then a *.PCX file, and lastly a
  650.     *.BLD file (which can be viewed only in MCGA 320x200x256 mode and must
  651.     have matching *.PLT files in the same drive/directory).
  652.  
  653.  
  654.     THE CHAINED VGACAD ENVIRONMENT
  655.  
  656.     BRUN41.exe is a runtime module distributed under licence with Microsoft
  657.     in connection with this program.  Place it with MVGAVU or anywhere your
  658.     DOS PATH has access to.  MVGAVU is a part of VGACAD.  ONLY ONE COPY OF
  659.     BRUN41.EXE IS REQUIRED.
  660.  
  661.                                                          
  662.     REGISTRATION
  663.  
  664.     REGISTRATION OF MVGAVU IS BASED ON 'PERSONAL USAGE'.  CORPORATE OR
  665.     ORGANIZATIONAL USERS *MUST* REGISTER ALL COPIES USED ON AN INDIVIDUAL
  666.     BASIS; A SPECIFIC PERSON (NAME) MUST BE EXPLICITLY ASSIGNED TO EACH
  667.     REGISTRANT WHO WILL BE PROVIDED WITH A CORRESPONDING REGISTER.OVL FILE TO
  668.     INDICATE REGISTERED USAGE.  REGISTRATION GRANTS A SPECIFIC PERSON (NOT A
  669.     JURIDICAL PERSON OR CORPORATE ENTITY) THE RIGHT TO 'USE' MVGAVU.
  670.  
  671.     ┌───────────────────────────────────────────────────────────────────┐
  672.     │ ALTHOUGH WE WILL TRY TO RESPOND TO YOUR REGISTRATION IN 2-3 WEEKS,│
  673.     │ PLEASE ALLOW UP TO 4-6 WEEKS DELAY TO PROCESS YOUR REGISTRATION.  │
  674.     └───────────────────────────────────────────────────────────────────┘
  675.  
  676.     As token of our appreciation (i.e., to registered users), we will send
  677.     you the the latest version of the VGACAD system; many of the programs
  678.     listed below do not require a graphics card.
  679.  
  680.     GIFPUB - converts 256 color GIF/PCX files to B&W images desktop
  681.     publishing (DTP) as .PCX (Ventura, First Publisher, Publisher's
  682.     Paintbrush, WP, Pagemaker).  Variable sizing/contrast/brightness.
  683.     Includes printing on IBM/Epson, HP Laser and compatible printers.
  684.     Variable sizes. 8 pics/page and/or  Single/Double Pass printing on
  685.     dot matrix printers. Preview in CGA/HGC/EGA/VGA/EEGA/SVGA. Histogram-
  686.     equalization.  No graphics card required.
  687.  
  688.     GIFBIT - converts B&W PCX files (e.g., scanner output to 32KBx32KB !)
  689.     to grey shades for VGACAD image processing, GIFPUB redithering or
  690.     printing, or VGA2EGA conversion - it edits those "scan line jitters".
  691.     Viewing modes in MCGA/VGA/SVGA.  No graphics card required.
  692.  
  693.     SQZGIF/EGA2VGA - converts LARGE GIF/PCX pics (to 2KBx2KBx256) to
  694.     several sizes and video modes using "color averaging" to blend/smooth
  695.     "jaggies" or fast interpolation.  Variable sizing.  Also, converts
  696.     GIFs (16 colors and below) and creates up to 256 new colors; outputs
  697.     directly to GIFPUB, GIFDOT, VGACAD, MVGAVU, VGA2CGA or VGA2EGA.
  698.     No graphics card required.
  699.  
  700.     GIFHEX (formerly VGA2EGA) - converts 256-color pictures to 16-color
  701.     EGA or VGA .  Error-distributed dithering.  User support to 1024x768.
  702.     Variable sizing/RGBICMY/contrast.  EGA/MCGA/VGA required.
  703.  
  704.     MVGAVU - latest version.
  705.  
  706.     VGACAD - extensive paint/image processing program for VGA/MCGA users
  707.     (edit GIFs up to 32KBx32KBx256 !!!); airbrushes, color and grey image
  708.     processing functions (smoothing, noise removal, shading, contrast
  709.     stretching, edge detection, ...), splines, Cut&Paste, variable sizing,
  710.     256-color gradient/pattern fills, MORE !  Full screen SuperVGA editing
  711.     and image processing function to 1024x768x256.   360x480x256 support.
  712.     MCGA/VGA required.
  713.  
  714.     VGA2CGA - converts 256 color GIFs to CGA!  See "405" colors in an
  715.     unsupported 160x100x16 CGA mode.  CGA/EGA/MCGA/VGA required.
  716.  
  717.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or
  718.     color and saves to .GIF or BLD/PLT file.  EGA/MCGA/VGA required.
  719.  
  720.     VGACAP - resident utility to capture 256-color MCGA/VGA or SVGA images.
  721.     FAST 640x480x256/16 or 800x600x256/16 and 1024x768x256/16 screen grabs.
  722.  
  723.     VGAFIL - GIF, PCX, BMP (Windows 3.x) and TGA (Targa 16) encoding
  724.     utility.  Accepts ALL RAW file formats used by our utilites as well as
  725.     BLD/PLT files.  This utility replaces RAW2GIF, RAW2PCX and BLD2GIF.
  726.  
  727.  
  728.     WHAT'S NEXT ?
  729.  
  730.     Aside from enhancing existing releases with greater capabilities (e.g.,
  731.     expanded memory, virtual screen, SVGA functions, other graphics
  732.     formats), we are developing VGACBT (Computer-Based Training program)
  733.     and MANNEQUIN for Advertising/Fashion Design or creating your own
  734.     artistic nudes.  We will try to develop and integrate more image
  735.     processing functions for all our applications; if you have any image
  736.     processing functions you would like to see, please let us know.
  737.  
  738.     In the short term, we are developing RGBLAB.  This is a color reduction
  739.     utility to 'downsize' 24-bit or 16 Million-color pictures to 256-colors.
  740.     RAW red, green and blue files, TIFF (*.TIF), TARGA (*.TGA) and Windows
  741.     3.x (*.BMP) files will be the main input sources.  IDTVGA dithering will
  742.     play a key role in previewing or rendering 24-bit images in SVGA
  743.     256-color modes.
  744.  
  745.     Support maverick authors like us and we will continue developing
  746.     products like nothing seen commercially - otherwise they will simply
  747.     "DIE" from lack of support !  Compare the cost/benefit ratio of any of
  748.     our products with commercial products.  You, and you alone, determine
  749.     whether it will be worthwhile to continue developing.  Support the
  750.     User-Supported (Shareware) concept.  Register your Shareware copies.
  751.     To register, send the registration form and check or money order payable
  752.     in USD to:
  753.  
  754.                                Dr. Marvin Gozum
  755.                   2 Independence Place #1105, 6th & Locust
  756.                             Philadelphia, PA 19106
  757.  
  758.  
  759.  
  760.     ACKNOWLEDGEMENT
  761.  
  762.     We would like to thank John Bridges for releasing VGAKIT.ARC which
  763.     included source code for 'bank switching' the Tseng, Paradise, Trident,
  764.     Everex, C&T, ATI, Oak chipsets and source for the popular 360x480x256
  765.     mode.  We would like to thank Mike Abrash for publishing source code (in
  766.     Programmer's Journal) for the 320x400x256 mode.  Seminal variants have
  767.     been developed based on their evolving work into MVGAVU.  We are grateful
  768.     to Don Babcock, for QBASM's GIF adaptations of Tom Pfau's Public Domain
  769.     LZW source (in LZW.ARC) for QB4 linking, which provided invaluable
  770.     guidance in resolving QB4 memory allocation problems.  Thanks a meg -
  771.     John, Mike, Don and Tom !
  772.  
  773.  
  774.     ───────────────────────────────────────────────────────
  775.     Graphics Interchange Format and GIF are trademarks (tm)
  776.     of CompuServe Inc. an H&R Block Company.
  777.  
  778.